EDT 3.2 - NETWORK DEPLOYMENT
Local version (with dongles)

This readme file describes how to deploy EDT in a network with a dongle server.
This information is not needed for standalone usage


1. Introduction
---------------

EDT consists of three components which can be selected in the EDT Setup Wizard:

- Simulator
- Admin (requires Simulator)
- Dongle server

In a typical network situation the installation procedure is as follows:

1. Create a directory on a network drive (e.g. on a file server) to store all files that need to be shared. In this manual E:\edt is used as an example.

2. Install the dongle server. This step is only required when a network dongle is used, it should be omitted when normal dongles are used.

3. Install Simulator on all computers that are used by students. 

4. Install Simulator and Admin on all computers that are used by teachers.

5. Create subdirectories for each group of students in E:\edt\log.

6. Set the permissions for the directories and files in E:\edt.



2. Installing the dongle server
-------------------------------

(Note: this should only be performed when a network dongle is used)

1. Check the 'Dongle server' checkbox in the 'Select Components' dialog of the EDT Setup Wizard. The other components (Simulator and Admin) are not required,
unless you want to run the Simulator on the computer that serves as dongle server.

2. Choose E:\edt as the location to store the dongle file, edt.mx.

3. Finish the installation.

4. Connect the dongle to the USB-port of the computer.

5. Start the dongle server from the Start menu: Programs->EDT->Dongle server. The server application (MATRIX - NET) appears as an icon in the system tray. Click the icon to see if the network dongle is found.

6. To run the server at system startup click the 'Settings' button in the MATRIX - NET application and check the 'Start Matrix-NET at system startup' checkbox.



3. Preparing the student computers
----------------------------------

1. Check the 'Simulator' checkbox in the 'Select Components' dialog of the EDT Setup Wizard.

2. Choose E:\edt\log as the location to store the log files in the EDT Setup Wizard. This location can be edited manually after installation by setting the LogDir variable in C:\Program Files\edt\edt.ini, e.g.:

	[settings]
	LogDir=E:\edt\log

3. Choose E:\edt\fault as the location to store the fault simulation files in the EDT Setup Wizard. After installation this directory is filled with .sto
files, which are associated by the setup wizard with the simulator. Double clicking a .sto file will launch C:\Program files\edt\bin\simulator.exe.

4. This step should only be performed when a dongle server is used (see above). Click 'yes' when the wizard asks 'Do you have a network dongle?' and select the
dongle file (E:\edt\edt.mx). This setting can be edited manually after installation by setting the DongleFile variable in C:\Program Files\edt\edt.ini, e.g:

	[settings]
	DongleFile=E:\edt\edt.mx

When this variable is not set, EDT will look for a dongle on the local USB port.

5. Finish the installation. This will create two shortcuts in the Start menu: 'Documentation' (to C:\Program Files\edt\doc\index.html) and 'Failures' (to the
directory with fault simulation files, E:\edt\fault).

6. Connect the dongle to the USB-port of the computer.



4. Preparing the teacher computers
----------------------------------

This procedure is identical to installing the student computers, except that in the 'Select Components' dialog the 'Admin' checkbox should be checked too. This
will install the Admin files to E:\edt\admin. 
After installation two additional shortcuts are created in the Start menu: 'Log' (to the log file directory E:\edt\log) and 'List' (to E:\edt\admin\list.html).



5. Creating group directories
-----------------------------

By default, the EDT Setup Wizard creates a subdirectory 'group1' in the log file directory E:\edt\log. Typically you want to create a subdirectory for every
group or class of students in E:\edt\log. When a student starts the Simulator by double clicking a fault simulation file, the student has to select a name of one of the subdirectories in E:\edt\log. The log file of the session is stored in the selected subdirectory.



6. Setting file permissions
---------------------------

1. Grant permission to read from and write to E:\edt\edt.mx to all accounts that need to access the dongle server, i.e. all student and teacher accounts and the account that runs the dongle server application.

2. Grant read access to E:\edt\fault to all accounts used by teachers and students.

3. Grant read access to E:\edt\admin and the files in the directory to accounts used by teachers. Student accounts should not have access to this directory.

4. Grant permission to list the directory contents of E:\edt\log to all student accounts. Do not grant permission to write or create files to student accounts
in this directory.

5. Grant permission to create, write and read files in all the subdirectories of E:\edt\log (created in section 5 above) to all student accounts. Permission to
list the directory contents of these subdirectories and delete files therein should not be granted.

6. Grant full control of E:\edt\log, it's subdirectories and log files to all teacher accounts. Teachers should be able to create, move and delete subdirectories in E:\edt\log and to read, move and delete log files in those subdirectories.
You may also choose a more restrictive policy by only granting permission to list the directory contents of the subdirectories and read the files in the
subdirectories.